home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / bicat45s.zip / BICATS.DOC < prev    next >
Text File  |  1992-02-07  |  11KB  |  236 lines
  1.                                   B i C a t s
  2.                                  Version  4.05
  3.  
  4.  
  5.                  WILDCAT 3.xx AND BIMODEM INTERFACE HELP DOC'S
  6.                  --------------------------------------------
  7.  
  8.    Here it is!  Wildcat and Bimodem, together again.
  9.  
  10.    If you have used Bimodem, you know it is a powerful file transfer
  11.    protocol that allows you to upload and download at the same time,
  12.    essentially doubling your throughput.  BiCats will interface Bimodem
  13.    to Wildcat so your users can enjoy this terrific protocol on your
  14.    Wildcat system.
  15.  
  16.    Setting things up is simple, and we'll go through it step by step.
  17.                                                                        
  18.               USE A WORK DIRECTORY FOR YOUR UNARCHIVING OF FILES
  19.  
  20.    Create a new directory to work in.  This keeps things much easier to
  21.    follow along with and clean up after.
  22.  
  23.    Ok, here we go.
  24.  
  25.    1.  Take all the .COM files from the Bimodem archive (BIMODxxx.ZIP)
  26.    and put them in any directory that you have your dos environment
  27.    'path' set up for.  Type 'set' at the dos prompt to check.  I set
  28.    everything into a directory called c:\wc\ep and include it in the
  29.    path statement in my autoexec.bat.
  30.  
  31.    2.  Do the same thing with BICAT1ST.EXE, BICAT2ND.EXE, and BIPASS.EXE
  32.    from this (BICATxxx.ZIP) archive.  All the files should now be
  33.    available in the path.
  34.  
  35.    3.  Place the copy of BIMODEM.CFG I have included into each of your
  36.    node home directories. IE: c:\wc30\wcwork\node1, c:\wc30\wcwork\node2,
  37.    etc.
  38.  
  39.    4.  In each directory that you put a copy of BIMODEM.CFG, run
  40.    BICONFIG to make changes necessary for your system.  The copy I have
  41.    included is a regular setup and should not require much modification,
  42.    except for 'Filenames and Paths'.  Make changes to this section as
  43.    follows. Remember to run BICONFIG from the node directory! You
  44.    should refer to the BiModem Docs for further information regarding
  45.    BiModem's options.
  46.  
  47.        A. 'Directory that files will be received into' should be left
  48.    blank.  BICAT1ST reads Wildcat's system files and prompts the
  49.    caller to enter the file area number. A ? will display the file
  50.    areas available to the callers security level. They will only be
  51.    allowed to specify an area they have access to from Wildcat.
  52.  
  53.        B.  'Directory that aborted files will be renamed into' should
  54.    also be left blank.
  55.  
  56.        C.  'Delete aborted destination files (Y/N)'  Should be N.
  57.    Bimodem allows for recovering transfers.  Aborted file transfers can
  58.    be continued at a later logon. Aborted transfers will be placed into
  59.    the sub directory \ABORT of the original area choosen.
  60.  
  61.        D.  'List of directory that determine rejections' should be the
  62.    name of a file that lists every directory that holds files you don't
  63.    want someone to try and upload again.   To make BIMODEM.REJ, list
  64.    all file directories in it, in the form;
  65.  
  66.              c:\-\1
  67.              c:\-\2
  68.              c:\-\3
  69.              etc., where each line is a directory that holds files you
  70.    don't want duplicated.  Note that this is an ASCII file.
  71.    BIMODEM.REJ should point to your HOME directory. IE: C:\wc30\bimodem.rej
  72.    That is also where you should create the file at.
  73.  
  74.  
  75.  
  76.       E.  'Directory or list of directories that files are sent from'
  77.    should be the path to your Node directory (c:\wc30\wcwork\node1\,
  78.    or whatever) and file name BIMODEM.001 (if node 1, 002 if node 2, and so on).
  79.    BICAT1ST will build the actual file for each caller, based on their
  80.    access as defined in the Wildcat system files.
  81.  
  82.       F.  'Path to password' should be the complete path and name of the
  83.    password file (PASSWORD.TXT) generated by BIPASS.EXE.  This should
  84.    point to your Wildcat home directory; c:\wc30\PASSWORD.TXT.
  85.    Which is where BIPASS.EXE must be run from in order to work. It is
  86.    a list of any files that you have online that are password protected.
  87.  
  88.       G.  'Path to Upload/Download' should be left blank.
  89.  
  90.       H.  'Path to default files list for BiList'  should be the path
  91.    and file name to your ASCII file list for the bbs, if you have one
  92.    IE: C:\TEXT\FILELIST.BBS.  Preferred format for this file is a single
  93.    line per file.
  94.  
  95.       I.  'Path to log file' must be left blank.
  96.  
  97.       J.  Connections/disconnections should not be logged.
  98.  
  99.       K.  File transfer statistics should not be logged.
  100.  
  101.    5. BICAT1ST will write to the CFG file when it is run, and supply the
  102.    connection info (port and speed), their max download bytes for the
  103.    day, time left, along with the information of the user's selected
  104.    upload area. The rest of the options are up to you the sysop. (see
  105.    the bimodem documentation for more detailed information).
  106.  
  107.    6.  Complete steps 4.A through 4.K for each one of your nodes if you
  108.    are multi-node Wildcat.
  109.  
  110.    7. Change into your home directory and copy the supplied BIMOD.BAT
  111.    file to either FILE1.BAT or FILE2.BAT, depending on which of the two
  112.    dos hooks you prefer to use.
  113.  
  114.    8.  Run Makewild (still in the home directory) and go to the File
  115.    Menu section.  Change the entry for the chosen dos hook to reflect
  116.    Bimodem. Change the menu key to B, and the description to
  117.    [B].......Bimodem Transfers.
  118.  
  119.    @ECHO OFF
  120.    BICAT1ST %nodepath%BIMODEM.CFG
  121.    BIMODEM /C %nodepath%BIMODEM.CFG / %nodepath%BIMODEM.LOG /E 0
  122.    BICAT2ND %nodepath%BIMODEM.LOG
  123.  
  124.    * Make sure you set the Wildcat Node Id and Port Id in the batch
  125.    file that calls Wildcat for each node used. This should be in your
  126.    Cat.Bat file that calls the node for operation. You Should also set
  127.    the following enviroment variables along with Node Id and Port Id.
  128.  
  129.    IE: Set WCNODEID=(node you are on ie: 1)
  130.        Set WCPORTID=(port you are using on that node ie: 1)
  131.        Set HOMEPATH=(path to home directory ie: C:\WC30\) 
  132.        Set NODEPATH=(path to node directory ie: C:\WC30\WCWORK\NODE1\)
  133.  
  134.    * Remember the extra backslash \ on directories above.
  135.  
  136.    * Remember, it is the / switch (slant control P) that creates the
  137.    special bimodem.log that BICATS uses to modify your Wildcat Database.
  138.  
  139.    * BiCat2nd.Exe now offers file virus scanning. If BiCat2nd.Exe
  140.    finds the file "SCANFILE.BAT" it will shell to EMS or DISK before
  141.    adding the file to Wildcat's database. ScanFile.Bat will do it's normal
  142.    job of scanning the file. If the file fails, BiCat2nd will add it to
  143.    the database with the failed scan flag set to Y. It will also subtract
  144.    the file and upload kilobytes from the users record. At present I have
  145.    only tested this with CatScan. I am not sure about the other file
  146.    scanners available, before using a different scanner than CatScan in
  147.    your ScanFile.Bat file make a backup for your own protection.
  148.  
  149.    9. Go to each of your possible upload file directories and create a
  150.    sub-directory off each called ABORT.
  151.  
  152.                                ┌──────────────┐
  153.                                │ UPLOAD NOTES │
  154.                                └──────────────┘
  155.  
  156.    Through the use of BICAT1ST.EXE, a single selectable upload area is
  157. supported, so the user may upload to an area of their choice that they
  158. have access to normally.  All uploads that occur during any one
  159. session will go to the area that the user so chooses, they will only
  160. be allowed to choose areas for which they have security for. This
  161. means for each BIMODEM session they can select the area they want to
  162. upload too.
  163.  
  164.    Save Upload's to Which Area ("?" for Choices) ?
  165.  
  166.    [1] New Uploads
  167.    [26] Sysop Only!
  168.  
  169.    They will only be shown areas for which they have security for in WC!
  170.   
  171.    * A future version of BiCats will have the ability to assign the area
  172.    automatically if you only allow 1 upload area to the user. At present
  173.    the user must still select the area manually.
  174.  
  175.                               ┌────────────────┐
  176.                               │ PASSWORD NOTES │
  177.                               └────────────────┘
  178.  
  179.    BIMODEM determines if a file is Password protected by the
  180.    PASSWORD.TXT file. If the file is password protected then the user
  181.    must enter the file they wish to download with their BIMENU as
  182.    FILENAME,PASSWORD as opposed to just FILENAME. If the Password is
  183.    correct then WILDCAT will let BIMODEM download the file, if
  184.    not...well it won't let them! This works the same for Uploads, if you
  185.    wish to upload a file that is password protected then do it just as
  186.    you would to downloading it, except in BIMENU you would be using the
  187.    "U" instead of the "D". The utility needed to make the PASSWORD.TXT
  188.    file is called BIPASS.EXE It MUST be executed from the Home
  189.    directory. Where it will make a list of all files that you have that
  190.    have a password attached. If you have selected to show password
  191.    protected files in Wildcat then you should place this command as part
  192.    of your PostCall.Bat and run it after every caller. This will make a
  193.    new PASSWORD.TXT file after every caller. Otherwise once a day should
  194.    be suffient to provide adaquate security for your files.
  195.  
  196.  
  197.                             MOST COMMON PROBLEMS
  198.  
  199.  
  200.    #1. Passwords fail due to improper entry into BiMenu. You need to use
  201.        the format: FILENAME,PASSWORD Please remember that the password
  202.        following the comma must be in CAPS!
  203.  
  204.  
  205.    So there you have it in a nut shell. It is easy to setup and totally
  206.    worth the effort!!!! If you should have any questions please feel
  207.    free to call me and I will help you out. I can be reached at my BBS
  208.    from 6pm till 6:00am (East Coast Time), Which at present is the only
  209.    hours my bbs will be up and running. PLEASE do not call anytime other
  210.    than the hours specified until I get another phone line installed.
  211.    The BBS # is (717)-731-8299 (19,200 V42/Bis) Good Luck and thanks for
  212.    supporting BICATS, BIMODEM & WILDCAT!
  213.  
  214.  
  215.  
  216.                                               Enjoy!        02/07/92
  217.  
  218.                                 Dale Fedorchik
  219.                              The Cat's Castle BBS
  220.  
  221.  
  222.                                  Warranty
  223.  
  224.  
  225.    This is product is provided "as is" without warranty of any kind. The
  226.    entire risk as to the results and performance of the program is
  227.    assumed by you. Futher more, I the author do not warrant, guarantee,
  228.    or make any representations regarding the use of, or the results of
  229.    the use of the program, and you rely on the program and results
  230.    solely at your own risk. I the author cannot accept responsibility
  231.    for system damage, loss of profit, or any other special, incidental,
  232.    or consequential damages resulting from the use or inability to use
  233.    this product.
  234.  
  235.  
  236.